Skip to content

feat: add markdown export support for issues#15

Merged
pchuri merged 2 commits intomainfrom
feat/markdown-export
Dec 11, 2025
Merged

feat: add markdown export support for issues#15
pchuri merged 2 commits intomainfrom
feat/markdown-export

Conversation

@pchuri
Copy link
Copy Markdown
Owner

@pchuri pchuri commented Dec 11, 2025

Summary

  • Add markdown export functionality to jira issue view command
  • Support viewing issues as markdown in terminal
  • Support exporting issues to markdown files

Changes

New Features

  • Added formatIssueAsMarkdown() function in lib/utils.js to convert issues to markdown format
  • Added --format <terminal|markdown> option to jira issue view command
  • Added --output <path> option to save issues to markdown files

Documentation

  • Updated README with markdown export examples
  • Updated command reference table
  • Updated roadmap to reflect completed markdown support

Usage Examples

View issue as markdown in terminal:

jira issue view PROJ-123 --format markdown

Export issue to markdown file:

jira issue view PROJ-123 --output ./issue.md

Markdown format includes:

  • Issue key and summary
  • Metadata (status, type, priority, assignee, reporter, dates, labels, URL)
  • Full description

Testing

  • All existing tests pass (91 tests)
  • Linting passes

Related Features

This complements the existing --description-file feature for creating/updating issues from markdown files, completing the markdown read/write workflow.

- Add formatIssueAsMarkdown() function to lib/utils.js
- Add --format and --output options to issue view command
- Support viewing issues as markdown in terminal with --format markdown
- Support exporting issues to markdown files with --output <path>
- Update README with markdown export examples and features
- Update roadmap to reflect completed markdown support
@pchuri pchuri requested a review from Copilot December 11, 2025 05:17
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds markdown export functionality to the JIRA CLI, enabling users to view issues in markdown format and export them to files. This completes the markdown read/write workflow alongside the existing --description-file feature.

Key Changes:

  • Added formatIssueAsMarkdown() function to convert issue data to markdown format
  • Extended jira issue view command with --format markdown and --output <path> options
  • Updated documentation to reflect new markdown capabilities

Reviewed changes

Copilot reviewed 2 out of 3 changed files in this pull request and generated 1 comment.

File Description
lib/utils.js Implements formatIssueAsMarkdown() function and exports it for use in commands
README.md Updates feature list, usage examples, command reference table, and roadmap to document markdown export support

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Replace string concatenation with template literals for better readability
@pchuri pchuri merged commit 9691ea5 into main Dec 11, 2025
5 checks passed
github-actions bot pushed a commit that referenced this pull request Dec 11, 2025
# [2.2.0](v2.1.2...v2.2.0) (2025-12-11)

### Features

* add markdown export support for issues ([#15](#15)) ([9691ea5](9691ea5))
@pchuri pchuri deleted the feat/markdown-export branch December 11, 2025 05:23
@github-actions
Copy link
Copy Markdown

🎉 This PR is included in version 2.2.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants